IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/g_man/cat3/OpenGL/glpixelstore.z/glpixelstore

Text File | 2001-04-17 | 64.1 KB | 723 lines

ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



NNNNAAAAMMMMEEEE
     ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeeeffff,,,, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeeeiiii - set pixel storage modes


CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
     void ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeeeffff( GLenum _p_n_a_m_e,
                         GLfloat _p_a_r_a_m )
     void ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeeeiiii( GLenum _p_n_a_m_e,
                         GLint _p_a_r_a_m )


PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     _p_n_a_m_e  Specifies the symbolic name of the parameter to be set.  Twelve
            values affect the packing of pixel data into memory:
            GGGGLLLL____PPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS, GGGGLLLL____PPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT, GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH,
            GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT, GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS,
            GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS, GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS, GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS,
            GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS, GGGGLLLL____PPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT,
            GGGGLLLL____PPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX, and GGGGLLLL____PPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX.  Twelve
            more affect the unpacking of pixel data _f_r_o_m memory:
            GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH,
            GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS,
            GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS,
            GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT,
            GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX, and GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX.

     _p_a_r_a_m  Specifies the value that _p_n_a_m_e is set to.

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee sets pixel storage modes that affect the operation of
     subsequent ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss and ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss as well as the unpacking of
     polygon stipple patterns (see ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee), bitmaps (see ggggllllBBBBiiiittttmmmmaaaapppp),
     and texture patterns (see ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD,
     ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, and
     ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS).  Additionally, if the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is
     supported, pixel storage modes affect convolution filters (see
     ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD, and ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD),
     color tables (see ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee and ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee), and unpacking
     histogram (see ggggllllHHHHiiiissssttttooooggggrrrraaaammmm) and minmax (see ggggllllMMMMiiiinnnnmmmmaaaaxxxx) data.

     _p_n_a_m_e is a symbolic constant indicating the parameter to be set, and
     _p_a_r_a_m is the new value.  Twelve of the twenty-four storage parameters
     affect how pixel data is returned to client memory.  They are as follows:

     GGGGLLLL____PPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS
               If true, byte ordering for multibyte color components, depth
               components, color indices, or stencil indices is reversed.
               That is, if a four-byte component consists of bytes b , b , b ,
                                                                    0   1   2
               b , it is stored in memory as b , b , b , b  if
                3                             3   2   1   0
               GGGGLLLL____PPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS is true.  GGGGLLLL____PPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS has no effect
               on the memory order of components within a pixel, only on the
               order of bytes within components or indices.  For example, the



                                                                        PPPPaaaaggggeeee 1111






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



               three components of a GGGGLLLL____RRRRGGGGBBBB format pixel are always stored
               with red first, green second, and blue third, regardless of the
               value of GGGGLLLL____PPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS.

     GGGGLLLL____PPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT
               If true, bits are ordered within a byte from least significant
               to most significant; otherwise, the first bit in each byte is
               the most significant one.  This parameter is significant for
               bitmap data only.

     GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH
               If greater than 0, GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH defines the number of
               pixels in a row.  If the first pixel of a row is placed at
               location p in memory, then the location of the first pixel of
               the next row is obtained by skipping


                                          (

                                          |       nl           s _> a

                                     k =  |
                                            a_|   snl___|      s < a
                                          |
                                           s| a |
                                          (




               components or indices, where n is the number of components or
               indices in a pixel, l is the number of pixels in a row
               (GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH if it is greater than 0, the width argument
               to the pixel routine otherwise), a is the value of
               GGGGLLLL____PPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT, and s is the size, in bytes, of a single
               component (if a<s, then it is as if a = s).  In the case of 1-
               bit values, the location of the next row is obtained by
               skipping

                                               |   nl__|
                                         k = 8a
                                               |8a|

               components or indices.

               The word _c_o_m_p_o_n_e_n_t in this description refers to the nonindex
               values red, green, blue, alpha, and depth.  Storage format
               GGGGLLLL____RRRRGGGGBBBB, for example, has three components per pixel:  first
               red, then green, and finally blue.

     GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT
               If greater than 0, GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT defines the number of
               pixels in an image of a three-dimensional texture volume, where
               an ``image'' consists of all pixels sharing the same third
               dimension index.  If the first pixel of an image is placed at
               location p in memory, then the location of the first pixel of
               the next image is obtained by skipping


                                         (

                                         |         nlh           s _> a

                                    k =  |
                                            a_|   snlh____|      s < a
                                         |
                                           s| a  |
                                         (







                                                                        PPPPaaaaggggeeee 2222






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



               components or indices, where n is the number of components or
               indices in a pixel, l is the number of pixels in a row
               (GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH if it is greater than 0,  the width
               argument to ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD otherwise), h is the number of rows in
               a pixel image (GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT if it is greater than 0,
               the height argument to the ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD routine otherwise), a
               is the value of GGGGLLLL____PPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT, and s is the size, in bytes,
               of a single component (if a<s, then it is as if a=s).

               The word _c_o_m_p_o_n_e_n_t in this description refers to the nonindex
               values red, green, blue, alpha, and depth.  Storage format
               GGGGLLLL____RRRRGGGGBBBB, for example, has three components per pixel:  first
               red, then green, and finally blue.

     GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS
               If greater than 0, GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS defines the number
               of pixels in a volume of a four-dimensional texture
               hypervolume, where a ``volume'' consists of all pixels sharing
               the same fourth dimension index.  If the first pixel of a
               volume is placed at location p in memory, then the location of
               the first pixel of the next volume is obtained by skipping


                                        (

                                        |          nlhd           s _> a

                                   k =  |
                                           a_|    snlhd_____|      s < a
                                        |
                                          s|  a  |
                                        (




               components or indices, where n is the number of components or
               indices in a pixel, l is the number of pixels in a row
               (GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH if it is greater than 0, the width argument
               to ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS otherwise, h is the number of rows in a
               pixel image (GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT if it is greater than 0, the
               height argument to the ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS routine otherwise), d
               is the number of images in a volume (GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS
               if it is greater than 0, the depth argument to the
               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS routine otherwise), a is the value of
               GGGGLLLL____PPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT, and s is the size, in bytes, of a single
               component (if a<s, then it is as if a=s).

               The word _c_o_m_p_o_n_e_n_t in this description refers to the nonindex
               values red, green, blue, alpha, and depth.  Storage format
               GGGGLLLL____RRRRGGGGBBBB, for example, has three components per pixel:  first
               red, then green, and finally blue.

     GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS, GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS, GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS,
               and GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS
               These values are provided as a convenience to the programmer;
               they provide no functionality that cannot be duplicated simply
               by incrementing the pointer passed to ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss.  Setting
               GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS to i is equivalent to incrementing the
               pointer by in components or indices, where n is the number of
               components or indices in each pixel.  Setting GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS



                                                                        PPPPaaaaggggeeee 3333






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



               to j is equivalent to incrementing the pointer by jm components
               or indices, where m is the number of components or indices per
               row, as just computed in the GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH section.
               Setting GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS to k is equivalent to incrementing
               the pointer by kp, where p is the number of components or
               indices per image, as computed in the GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT
               section.  Setting GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS to k is equivalent
               to incrementing the pointer by kp, where p is the number of
               components or indices per volume, as computed in the
               GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS section.

     GGGGLLLL____PPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT
               Specifies the alignment requirements for the start of each
               pixel row in memory.  The allowable values are 1 (byte-
               alignment), 2 (rows aligned to even-numbered bytes), 4 (word-
               alignment), and 8 (rows start on double-word boundaries).

     GGGGLLLL____PPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX
               Specifies the subsample conversion rate that is applied to
               packed pixel stores.  The accepted _p_a_r_a_m values are
               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____4444444444444444____SSSSGGGGIIIIXXXX, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____2222444422224444____SSSSGGGGIIIIXXXX, and
               GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____4444222244442222____SSSSGGGGIIIIXXXX.  When set to other than the
               default GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____4444444444444444____SSSSGGGGIIIIXXXX value, RGB and RGBA pixel
               groups are sampled to produce two-value packed pixel groups.
               The width argument to the pixel routine must be a multiple of 2
               pixels.  The red, green, and blue components of the pixel are
               sampled in the order specified by the destination format.  When
               a 4-component format is specified, the alpha component is
               ignored. Subsampled pixel pairs are packed as follows:

               2424 - decimate :              4242 - decimate :

               <U00,U01,U02> <U10,U11,U12>    <U00,U01,U02> <U10,U11,U12>
                 |   |   |         |            |   |   |___   ___|
                 |   |   |         |             \ /        \ /
                 |   |    \       /               X          X
                 |   |     \     /               / \        / \
                 |   |      |   |               |   |      |   |
                 V   V      V   V               V   V      V   V
               <P00,P01>  <P10,P11>           <P00,P01>  <P10,P11>


     GGGGLLLL____PPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX
               Specifies the resample mode in effect when a pack subsample
               rate is being applied.  The only currently allowable value is
               GGGGLLLL____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____DDDDEEEECCCCIIIIMMMMAAAATTTTEEEE____SSSSGGGGIIIIXXXX. When the subsample rate is not
               uniform for all components, the components that are sampled at
               the lower-rate in the second group of each pixel pair are
               ignored.






                                                                        PPPPaaaaggggeeee 4444






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



     The other twelve of the twenty-four storage parameters affect how pixel
     data is read from client memory.  These values are significant for
     ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS,
     ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS,
     ggggllllBBBBiiiittttmmmmaaaapppp, and ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee.

     Additionally, if the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee,
     ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD, and
     ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD.  They are as follows:

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS
          If true, byte ordering for multibyte color components, depth
          components, color indices, or stencil indices is reversed.  That is,
          if a four-byte component consists of bytes b , b , b , b , it is
                                                      0   1   2   3
          taken from memory as b , b , b , b  if GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS is true.
                                3   2   1   0
          GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS has no effect on the memory order of components
          within a pixel, only on the order of bytes within components or
          indices.  For example, the three components of a GGGGLLLL____RRRRGGGGBBBB format pixel
          are always stored with red first, green second, and blue third,
          regardless of the value of GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS.

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT
          If true, bits are ordered within a byte from least significant to
          most significant; otherwise, the first bit in each byte is the most
          significant one.  This is relevant only for bitmap data.

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH
          If greater than 0, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH defines the number of pixels
          in a row.  If the first pixel of a row is placed at location p in
          memory, then the location of the first pixel of the next row is
          obtained by skipping


                                       (

                                       |        nl           s _> a

                                  k =  |
                                          a_|   snl___|      s < a
                                       |
                                         s| a |
                                       (




          components or indices, where n is the number of components or
          indices in a pixel, l is the number of pixels in a row
          (GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH if it is greater than 0, the width argument to
          the pixel routine otherwise), a is the value of GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT,
          and s is the size, in bytes, of a single component (if a<s, then it
          is as if a=s).  In the case of 1-bit values, the location of the
          next row is obtained by skipping

                                             |   nl__|
                                       k = 8a
                                             |8a|

          components or indices.

          The word _c_o_m_p_o_n_e_n_t in this description refers to the nonindex values
          red, green, blue, alpha, and depth.  Storage format GGGGLLLL____RRRRGGGGBBBB, for
          example, has three components per pixel:  first red, then green, and



                                                                        PPPPaaaaggggeeee 5555






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



          finally blue.

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT
          If greater than 0, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT defines the number of
          pixels in an image of a three-dimensional texture volume, where an
          ``image'' consists of all pixels sharing the same third dimension
          index.  If the first pixel of an image is placed at location p in
          memory, then the location of the first pixel of the next image is
          obtained by skipping


                                      (

                                      |         nlh           s _> a

                                 k =  |
                                         a_|   snlh____|      s < a
                                      |
                                        s| a  |
                                      (




          components or indices, where n is the number of components or
          indices in a pixel, l is the number of pixels in a row
          (GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH if it is greater than 0, the width argument to
          ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD otherwise), h is the number of rows in an image
          (GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT if it is greater than 0, the height argument
          to ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD otherwise), a is the value of GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT,
          and s is the size, in bytes, of a single component (if a<s, then it
          is as if a = s).

          The word _c_o_m_p_o_n_e_n_t in this description refers to the nonindex values
          red, green, blue, alpha, and depth.  Storage format GGGGLLLL____RRRRGGGGBBBB, for
          example, has three components per pixel:  first red, then green, and
          finally blue.

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS
          If greater than 0, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS defines the number of
          pixels in a volume of a four-dimensional texture hypervolume, where
          a ``volume'' consists of all pixels sharing the same fourth
          dimension index.  If the first pixel of a volume is placed at
          location p in memory, then the location of the first pixel of the
          next volume is obtained by skipping


                                      (

                                      |          nlhd           s _> a

                                 k =  |
                                         a_|    snlhd_____|      s < a
                                      |
                                        s|  a  |
                                      (




          components or indices, where n is the number of components or
          indices in a pixel, l is the number of pixels in a row
          (GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH if it is greater than 0, the width argument to
          ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD otherwise), h is the number of rows in an image
          (GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT if it is greater than 0, the height argument
          to ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD otherwise), d is the number of images in a volume
          (GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS if it is greater than 0, the depth
          argument to the ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS routine otherwise), a is the value
          of GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT, and s is the size, in bytes, of a single
          component (if a<s, then it is as if a = s).



                                                                        PPPPaaaaggggeeee 6666






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



          The word _c_o_m_p_o_n_e_n_t in this description refers to the nonindex values
          red, green, blue, alpha, and depth.  Storage format GGGGLLLL____RRRRGGGGBBBB, for
          example, has three components per pixel:  first red, then green, and
          finally blue.

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS, GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS,
          and GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS
          These values are provided as a convenience to the programmer; they
          provide no functionality that cannot be duplicated by incrementing
          the pointer passed to ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
          ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllBBBBiiiittttmmmmaaaapppp, or ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee.
          Setting GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS to i is equivalent to incrementing the
          pointer by in components or indices, where n is the number of
          components or indices in each pixel.  Setting GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS to
          j is equivalent to incrementing the pointer by jk components or
          indices, where k is the number of components or indices per row, as
          just computed in the GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH section.  Setting
          GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS to k is equivalent to incrementing the pointer
          by kp, where p is the number of components or indices per image, as
          computed in the GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT section.  Setting
          GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS to k is equivalent to incrementing the
          pointer by kp, where p is the number of components or indices per
          volume, as computed in the GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS section.

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT
          Specifies the alignment requirements for the start of each pixel row
          in memory.  The allowable values are 1 (byte-alignment), 2 (rows
          aligned to even-numbered bytes), 4 (word-alignment), and 8 (rows
          start on double-word boundaries).

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX
          Specifies the subsample conversion rate that is applied when
          unpacking pixel data.  The accepted _p_a_r_a_m values are
          GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____4444444444444444____SSSSGGGGIIIIXXXX, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____2222444422224444____SSSSGGGGIIIIXXXX, and
          GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____4444222244442222____SSSSGGGGIIIIXXXX.  When set to other than the default
          GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____4444444444444444____SSSSGGGGIIIIXXXX value, pixel groups are upsampled to
          produce RGB or RGBA component groups, depending on the source
          format.  The packed subsampled source pixel is composed of two
          values, and the width argument to the pixel routine must be a
          multiple of 2 pixels.  The unpacked pixel group is composed of R, G,
          and B components in the order specified by the format.  When a 4-
          component format is specified, an alpha component is added to the
          unpacked group and set to the maximum clamped value of the source
          type.  Pixel group values are also affected by the state of the
          GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX mode. Subsampled pixel pairs are unpacked as
          follows:









                                                                        PPPPaaaaggggeeee 7777






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



          2424 - replicate :             2424 - zero-fill :

          <P00,P01>     <P10,P11>        <P00,P01>     <P10,P11>
            |   |         |   |            |   |         |   |
            |   |   o-----o---+---o        |   |   o-----o   |
            |   |   |         |   |        |   |   |         |
            o---+---+-----o   |   |        |   |   |    0.0  |  0.0
            |   |   |     |   |   |        |   |   |     |   |   |
            V   V   V     V   V   V        V   V   V     V   V   V
          <U00,U01,U02> <U10,U11,U12>    <U00,U01,U02> <U10,U11,U12>


          4242 - replicate :             4242 - zero-fill :

          <P00,P01>     <P10,P11>        <P00,P01>     <P10,P11>
            |   |       __\ __|_           |   |       __\ __|
             \ / \____ /   \    \           \ /       /   \
              X       X__   \    \           X       /     \
             / \     /   \   \    |         / \     /   0.0 \   0.0
            |   |   |     |   |   |        |   |   |     |   |   |
            V   V   V     V   V   V        V   V   V     V   V   V
          <U00,U01,U02> <U10,U11,U12>    <U00,U01,U02> <U10,U11,U12>

     GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX
          Specifies the resample mode in effect when an unpack subsample rate
          is being applied.  The accepted _p_a_r_a_m values are
          GGGGLLLL____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____RRRREEEEPPPPLLLLIIIICCCCAAAATTTTEEEE____SSSSGGGGIIIIXXXX and GGGGLLLL____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____ZZZZEEEERRRROOOO____FFFFIIIILLLLLLLL____SSSSGGGGIIIIXXXX.  When
          GGGGLLLL____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____ZZZZEEEERRRROOOO____FFFFIIIILLLLLLLL____SSSSGGGGIIIIXXXX is selected, the lower-rate sampled
          components in the second group of each pixel pair are assigned a
          zero value.  Otherwise the lower-rate components replicate
          corresponding values from the preceding unpacked group.

     The following table gives the type, initial value, and range of valid
     values for each storage parameter that can be set with ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee.


 _p_n_a_m_e                            TTTTyyyyppppeeee     IIIInnnniiiittttiiiiaaaallll VVVVaaaalllluuuueeee        VVVVaaaalllliiiidddd RRRRaaaannnnggggeeee
 GGGGLLLL____PPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS              boolean       false           true or false
 GGGGLLLL____PPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT               boolean       false           true or false
 GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH              integer         0                 [0,oo)
 GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT            integer         0                 [0,oo)
 GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS        integer         0                 [0,oo)
 GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS               integer         0                 [0,oo)
 GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS             integer         0                 [0,oo)
 GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS             integer         0                 [0,oo)
 GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS       integer         0                 [0,oo)
 GGGGLLLL____PPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT               integer         4             1, 2, 4, or 8
 GGGGLLLL____PPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX      enum         4444         4444, 2424, or 4242
 GGGGLLLL____PPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX            enum       decimate             decimate
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS            boolean       false           true or false





                                                                        PPPPaaaaggggeeee 8888






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT             boolean       false           true or false
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH            integer         0                 [0,oo)
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT          integer         0                 [0,oo)
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS      integer         0                 [0,oo)
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS             integer         0                 [0,oo)
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS           integer         0                 [0,oo)
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS           integer         0                 [0,oo)
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS     integer         0                 [0,oo)
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT             integer         4             1, 2, 4, or 8
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX    enum         4444         4444, 2424, or 4242
 GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX          enum       replicate     replicate or zero-fill


     ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeeeffff can be used to set any pixel store parameter.  If the
     parameter type is boolean, then if _p_a_r_a_m is 0, the parameter is false;
     otherwise it is set to true.  If _p_n_a_m_e is a integer type parameter, _p_a_r_a_m
     is rounded to the nearest integer.

     Likewise, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeeeiiii can also be used to set any of the pixel store
     parameters.  Boolean parameters are set to false if _p_a_r_a_m is 0 and true
     otherwise.

NNNNOOOOTTTTEEEESSSS
     The pixel storage modes in effect when ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss,
     ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS,
     ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS,
     ggggllllBBBBiiiittttmmmmaaaapppp, or ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee is placed in a display list control the
     interpretation of memory data.  Likewise, if the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension
     is supported, the pixel storage modes in effect when ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee,
     ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD, of
     ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD is placed in a display list control the
     intrepretation of memory data.  The pixel storage modes in effect when a
     display list is executed are not significant.

     Pixel storage modes are client state and must be pushed and restored
     using
     ggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb and ggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb.

EEEERRRRRRRROOOORRRRSSSS
     GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _p_n_a_m_e is not an accepted value.

     GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if a negative row length, pixel skip, or
     row skip value is specified, or if alignment is specified as other than
     1, 2, 4, or 8, or if subsample rate or resample is specified with a value
     that is not accepted.

     GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee is executed between the
     execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.







                                                                        PPPPaaaaggggeeee 9999






ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee((((3333GGGG))))



ASSOCIATED GETS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLSSSSUUUUMMMMEEEE____SSSSGGGGIIIISSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX
     ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRROOOOWWWW____LLLLEEEENNNNGGGGTTTTHHHH
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____IIIIMMMMAAAAGGGGEEEE____DDDDEEEEPPPPTTTTHHHH____SSSSGGGGIIIISSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____RRRROOOOWWWWSSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____PPPPIIIIXXXXEEEELLLLSSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____IIIIMMMMAAAAGGGGEEEESSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSKKKKIIIIPPPP____VVVVOOOOLLLLUUUUMMMMEEEESSSS____SSSSGGGGIIIISSSS
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____AAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____RRRRAAAATTTTEEEE____SSSSGGGGIIIIXXXX
     ggggllllGGGGeeeetttt with argument GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____RRRREEEESSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIIXXXX


MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
     The SSSSGGGGIIIIXXXX____ssssuuuubbbbssssaaaammmmpppplllleeee and SSSSGGGGIIIIXXXX____rrrreeeessssaaaammmmpppplllleeee extensions are supported only on
     OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems.  Applying the GGGGLLLL____PPPPIIIIXXXXEEEELLLL____SSSSUUUUBBBBSSSSAAAAMMMMPPPPLLLLEEEE____2222444422224444____SSSSGGGGIIIIXXXX
     subsample rate is accelerated for direct immmediate mode transfers when
     the format is GGGGLLLL____RRRRGGGGBBBB or GGGGLLLL____RRRRGGGGBBBBAAAA, and the type is GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE or
     GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT.


SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ggggllllBBBBiiiittttmmmmaaaapppp, ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee, ggggllllCCCCoooolllloooorrrrSSSSuuuubbbbTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD,
     ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllHHHHiiiissssttttooooggggrrrraaaammmm,
     ggggllllMMMMiiiinnnnmmmmaaaaxxxx, ggggllllPPPPiiiixxxxeeeellllMMMMaaaapppp, ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ggggllllPPPPiiiixxxxeeeellllZZZZoooooooommmm, ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee,
     ggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb, ggggllllRRRReeeeaaaaddddPPPPiiiixxxxeeeellllssss, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
     ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD,
     ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee4444DDDDSSSSGGGGIIIISSSS













                                                                       PPPPaaaaggggeeee 11110000